wcDoit! v1.0 A Message Posting Utility For WildCat v4.01 Written in wcCODE v4.01 By: Leon Krzyzanowski FREEWARE You may freely distribute, upload or make available for download this archive in its original archive form. Also, you are free to use and modify the source code for prelog.wcc in any way that you so desire. If you do alter the programs, the source code or the documentation in any way you cannot distribute, upload or make available for download the altered programs, source code or the documentation using my Name or the name wcDoit!. DISCLAIMER: These programs are provided "AS IS" without warranty of any kind. The entire risk as to the results and performance of these programs is assumed by you. I the author and anyone who distributes these programs do not warrant, guarantee, or make any representations regarding the use of the programs or the results from the use of the programs. If you use these programs you do so at your own risk. I the author and anyone who distributes these programs cannot accept and will not accept responsibility for system damage, loss of profit, or any other special, incidental, or consequential damages resulting from the use or inability to use these programs. YOU ARE FORBIDDEN TO INSTALL THESE PROGRAMS ON ANY COMPUTER AND YOU ARE FORBIDDEN TO USE THESE PROGRAMS IF YOU CAN NOT ACCEPT THE TERMS OF THIS DISCLAIMER NOTICE. WHAT IS wcDOIT! v1.0: wcDoit! is a wcCODE message posting utility for WildCat v4.01 that will send a text message to every user in one security level that you specify. It was written for the purpose of sending a text file to a newuser before that user logs on to a BBS for the second time. It has an option to attach a file to every message that it sends to the specified security level. wcDoit! will change the security level of the newuser to any security level you choose and it will set their expiration date (if you wish to do so). It will send either a public or private message to the conference of your choice. I wrote this wcCODE program to be run from prelog.wcx. It's ideal for sending a Welcome Back message to a newuser before their second call to your BBS with a file attached (if you wish to do so) for downloading. wcDoit also maintains a log of the messages sent and an error log. FILES INCLUDED: Desc.sdi - Short description of wcDoit! File_id.diz - Long description of wcDoit! Hiagain.txt - Sample text file message Prelog.wcc - wcCODE v4.01 source code file for the program prelog.wcx Prelog.wcx - Prelog.wcx program file compiled with wcCODE v4.01 wcDoit!.cfg - wcDoit! configuration file wcDoit!.txt - This file that you are reading wcDoit!.wcx - wcDoit! program file compiled with wcCODE v4.01 wcDoit!.his - wcDoit! History file FILES CREATED BY wcDoit!: wcdoit!.log - This is a log of the messages sent. You can periodically delete the text in this file to reduce the size of the file. You can also delete this file. It will be created again the next time a message is sent. wcdoit!.err - This is the wcDoit! error log. You can periodically delete the text in this file to reduce the size of the file. Hopefully there will be none to delete. Or you can delete the file. OHOH!.txt - This is a temporary text file that is created and sent to the Sysop if the file wcDoit!.cfg does not exist in WildCat's home directory. The file is deleted when the wcDoit! program ends. DECISION MAKING TIME & INSTALLATION: You must decide which way you want to install wcDoit!. IF YOU DO NOT HAVE prelog.wcx installed for WildCat v4.01 you can do the following: INSTALLATION: 1. Unzip the archive into WildCat's home directory. 2. Edit the wcDoit!.cfg file.(See wcDoit!.cfg section below.) 3. Installation is complete. IF YOU DO HAVE a prelog.wcx file installed for WildCat you can do the following: INSTALLATION: 1. Unzip the archive into a temporary directory. 2. Edit YOUR EXISTING prelog.wcc file with wcCode v4.01 by copying the contents of the prelog.wcc file included with this archive, recompile it, and copy the newly compiled prelog.wcx into WildCat's home directory. 3. Edit the wcDoit!.cfg file and copy it into the WildCat home directory. (See wcDoit!.cfg section below.) 4. Copy the wcdoit!.wcx file to WildCat's home directory. 4. Installation is complete. wcDoit!.cfg: This file MUST EXIST in WildCat's home directory or a message will be sent to the SysOp EVERY TIME someone logs on the BBS until the problem is corrected. These are the options that you can change in the configuration file. Do not change anything to the left of the equal(=) sign. Only change the options on the right side. Letters do not need to be caps. All data MUST be entered in the first position after the equal sign. CONFERENCE=1 PUBLICPRIVATE=YES OLDSECLEVEL=NEWUSER NEWSECLEVEL=VISITOR MSGFROMWHO=SYSOP MSGSUBJ=Welcome Back Again! MSGTOSEND=c:\wildcat\text\hiagain.txt MSGATTACHMENT=c:\wildcat\xfers\free\mybbs.zip NUMOFDAYS=14 HOW TO CONFIGURE wcDOIT!.CFG: CONFERENCE Enter the conference number where you want the message to be posted. If you leave this option blank the message will be sent to WildCat's default conference which is conference 0. The message will be sent as private or public mail depending on how you have configured the PUBLICPRIVATE option in the wcDoit! configuration file. PUBLICPRIVATE Enter YES for private message or enter NO for public message. Please note that this option will override whatever you have configured the conference for in the MakeWild program. It will send private mail to a conference that does not allow private mail in MakeWild. If you leave this option blank it will be sent as public mail. OLDSECLEVEL THIS OPTION MUST BE ENTERED. Enter the security level of the user that you specified in the MakeWild program for a newuser. If you leave this blank an error message will be logged in the wcdoit!.err file and the wcDoit! program will terminate. NEWSECLEVEL THIS OPTION MUST BE ENTERED. Enter the new security level you wish the user to be changed to. The security level you enter MUST EXIST in MakeWild or the security level of the user will be changed to a level that DOES NOT EXIST. If it does not exist in MakeWild the user will not be able to log on. If you leave this blank an error message will be logged in the wcdoit!.err file and the wcDoit! program will terminate. MSGFROMWHO Enter the name of the person sending the message. You can enter a person's name here or you can enter the word SysOp. You may enter a person's name here even if the person does not exist in the user record. If you enter the word SysOp here, the name of the SysOp configured in MakeWild will be used. If you leave this option blank the message will be from the WildCat Mail Room. MSGSUBJ Enter the subject of the message that is being sent. If this option is left blank the subject will be "Welcome Back Again!" MSGTOSEND THIS OPTION MUST BE ENTERED. Enter the path and name of the text file to be sent to the user. If the text file does not exist or you leave this blank an error message will be logged in the wcdoit!.err file and the wcDoit! program will terminate. MSGATTACHMENT Enter the path and name of file to be attached to the message. You may leave this blank if you do not wish to attach a file to the message. If the file attachment does not exist an error message will be logged in the wcdoit!.err file and the wcDoit! program will terminate. NUMOFDAYS Enter the number of days that the user will have until the new security level expires. The new expire date will be the number of days you specify added on to the current date of the day the message is sent to the user. If you leave this option blank, or use a 0, there will be no change to the user's expiration date. ERROR CHECKING: I spent a LOT OF TIME checking to ensure that this program runs as it was intended to run. However, if any errors are detected or you need any help setting wcDoit! up please feel free to contact me. I will try my best to help you out. I can be contacted via: Name: Leon Krzyzanowski CompuServe: ID# 74357,1436 I also frequent MSI's BBS usually every weekend to check out what's new. I am currently setting up my WC and I am a very patient fellow. I refuse to open her up until I have completely satisfied myself that everything is set up the way I want it to be. That is why I can only be contacted at CompuServe & MSI at this time. IN CLOSING: If enough interest is shown in this program and if I receive some ideas from you SysOp's on how to further enhance this program you will most likely be hearing from me again. This is a simple program and some of it's features can be accomplished by other means. I wrote this program to help myself learn the wcCODE language and to provide an alternate way of doing things. I also feel that this program may be of some use to some of you out there who do not have wcCODE. Thank You, Leon Krzyzanowski